return "PUSH BUTTON" & RETURN & RETURN & "This behavior sets the member of a sprite depending on the state of the mouse (elsewhere, rollover, mouseDown, mouseUp)." & RETURN & RETURN & "This creates a button which can either initiate actions in other sprites, or provide visual feedback for other behaviors attached to the same sprite." & RETURN & RETURN & "The behavior can be enabled or disabled, using a #PushButton_ToggleActive call to the behavior or the sprite." & RETURN & RETURN & "Two messaging systems are provided:" & RETURN & "1) A custom message is sent to all sprites whenever the Push Button behavior is activated." & RETURN & RETURN & "2) Objects can 'subscribe' to the behavior in order to receive PushButton_Activated, _Enabled and _Disabled messages. A two-way messaging system allows for cleaning up object references before an object is destroyed." & RETURN & RETURN & "The behavior can be set to consider that all sprites in higher channels either block or let through all mouse events. If mouse events are allowed to pass, you can place blended sprites above the button to change its color. If mouse events are blocked, such translucent sprites provide an alternative method for disabling the button." & RETURN & RETURN & "PERMITTED MEMBER TYPES" & RETURN & PermittedMemberTypes(me) & RETURN & RETURN & "PARAMETERS:" & RETURN & "* Standard member (when mouse is elsewhere)" & RETURN & "* Rollover member" & RETURN & "* MouseDown member" & RETURN & "* Disabled member" & RETURN & "Optional parameters:" & RETURN & "* MouseDown sound" & RETURN & "* MouseUp sound" & RETURN & "If members are placed consecutively in the cast in this order then default values can be used to create the button." & RETURN & RETURN & "* Do sprites above the button allow mouse events through?" & RETURN & "* Custom Message sent to other sprites on mouseUp"
end
on getBehaviorTooltip me
return "Use with graphic members." & RETURN & RETURN & "+ Swaps the member of the sprite according to the state of the mouse" & RETURN & "+ Can play a brief sound on mouseDown and/or mouseUp" & RETURN & "+ Sends a custom message of your choice to all other sprites." & RETURN & RETURN & "Trigger actions of other sprites with this dynamic button behavior" & RETURN & "or use it to provide visual feedback for other behaviors on the same" & RETURN & "sprite (for example: 'Jump to Marker Button')." & RETURN & "This behavior can also interact with custom objects."
on PushButton_Subscribe me, callingBehavior, theMessage
if not voidp(theMessage) then
if theMessage <> myMessage then
exit
end if
end if
if mySubscribersList.getPos(callingBehavior) then
exit
else
if objectp(callingBehavior) then
mySubscribersList.append(callingBehavior)
return me
end if
end if
end
on PushButton_Unsubscribe me, callingBehavior
mySubscribersList.deleteOne(callingBehavior)
end
on ErrorAlert me, theError, data
case theError of
#getPDLError:
alert("Error: This behavior works only with the following members types: " & PermittedMemberTypes(me) & RETURN & RETURN & "Hit OK and then delete this behavior from the sprite. See the Help system for details on deleting behaviors.")
alert("BEHAVIOR ERROR: Frame " & the frame & ", Sprite " & me.spriteNum & RETURN & RETURN & "Behavior " & behaviorName & " only works with Field and Text members." & RETURN & RETURN & "Current member type = #" & data)
end if
abort()
#spaceInMessage:
if the runMode = "Author" then
alert("BEHAVIOR ERROR: Frame " & the frame & ", Sprite " & me.spriteNum & RETURN & "Behavior " & behaviorName & RETURN & RETURN & "Message includes spaces: " & QUOTE & data & QUOTE & RETURN & "Only the first word will be used in sendAllSprite calls:" & RETURN & RETURN & "sendAllSprites (#" & data.word[1] & ", <me>, " & spriteNum & ")")
descriptionList.addProp(#myMouseDownSound, [#comment: "- SOUNDS - Sound to play on mouseDown:", #format: #sound, #range: soundsAvailable, #default: member(theMemberNum + 4)])
descriptionList.addProp(#myMouseUpSound, [#comment: "Sound to play on mouseUp:", #format: #sound, #range: soundsAvailable, #default: member(theMemberNum + 5)])
 (Disc 2) (Press Kit).bin/Credits.dcr/00019_LogoJaune.png){kind=link}